home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / rotate.z / rotate
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. rrrroooottttaaaatttteeee((((3333GGGG))))                                                          rrrroooottttaaaatttteeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrroooottttaaaatttteeee,,,, rrrrooootttt - rotates the current matrix
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd rrrroooottttaaaatttteeee((((aaaa,,,, aaaaxxxxiiiissss))))
  13.      AAAAnnnngggglllleeee aaaa;;;;
  14.      cccchhhhaaaarrrr aaaaxxxxiiiissss;;;;
  15.  
  16.      vvvvooooiiiidddd rrrrooootttt((((aaaa,,,, aaaaxxxxiiiissss))))
  17.      ffffllllooooaaaatttt aaaa;;;;
  18.      cccchhhhaaaarrrr aaaaxxxxiiiissss;;;;
  19.  
  20. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  21.      _a      expects the angle of rotation.
  22.  
  23.      _a_x_i_s   expects the relative axis of rotation.  There are three character
  24.             literal values for this parameter:
  25.  
  26.             ''''xxxx'''' indicates the _x-axis.
  27.  
  28.             ''''yyyy'''' indicates the _y-axis.
  29.  
  30.             ''''zzzz'''' indicates the _z-axis.
  31.  
  32. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.      rrrroooottttaaaatttteeee and rrrrooootttt specify an angle (_a) and an axis of rotation (_a_x_i_s).  The
  34.      angle given to rrrroooottttaaaatttteeee is an integer and is specified in tenths of degrees
  35.      according to the right-hand rule.  The angle given to rrrrooootttt is a floating
  36.      point value and is specified in degrees according to the right-hand rule.
  37.  
  38.      The angle and axis are used to compute a 4x4 rotation matrix, which then
  39.      premultiplies the current matrix, as specified by mmmmmmmmooooddddeeee.  Thus if _T is
  40.      the current matrix, and _R is the rotation matrix computed by rrrroooottttaaaatttteeee or
  41.      rrrrooootttt, _T is replaced with _R*_T.  The current matrix is the top matrix on the
  42.      transformation stack if mmmmmmmmooooddddeeee is MMMMSSSSIIIINNNNGGGGLLLLEEEE, the top matrix on the ModelView
  43.      matrix stack if mmmmmmmmooooddddeeee is MMMMVVVVIIIIEEEEWWWWIIIINNNNGGGG, the Projection matrix if mmmmmmmmooooddddeeee is
  44.      MMMMPPPPRRRROOOOJJJJEEEECCCCTTTTIIIIOOOONNNN, or the Texture matrix if mmmmmmmmooooddddeeee is MMMMTTTTEEEEXXXXTTTTUUUURRRREEEE.
  45.  
  46.      All objects drawn after rrrroooottttaaaatttteeee or rrrrooootttt is called while mmmmmmmmooooddddeeee is either
  47.      MMMMSSSSIIIINNNNGGGGLLLLEEEE or MMMMVVVVIIIIEEEEWWWWIIIINNNNGGGG are rotated.  Use ppppuuuusssshhhhmmmmaaaattttrrrriiiixxxx and ppppooooppppmmmmaaaattttrrrriiiixxxx to
  48.      preserve and restore the unrotated coordinate system.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      mmode, popmatrix, pushmatrix, scale, translate
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.